home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / faxgetty.Z / faxgetty
Text File  |  2002-07-08  |  4KB  |  77 lines
  1. FAXGETTY(${MANNUM1_8})               FAXGETTY(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        faxgetty    - _H_y_l_a_F_A_X front-door process
  7.  
  8. SSYYNNOOPPSSIISS
  9.        $${{LLIIBBEEXXEECC}}//ffaaxxggeettttyy [ --DD    ] [ --pp ] [ --qq _q_u_e_u_e_-_d_i_r    ] _d_e_v_i_c_e
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.        _f_a_x_g_e_t_t_y     is  the  _H_y_l_a_F_A_X server program that listens for
  13.        incoming    phone calls and    either handles each call directly
  14.        or  hands  it  off to an    appropriate program.  In addition
  15.        _f_a_x_g_e_t_t_y    monitors modem usage  and  notifies  the  _H_y_l_a_F_A_X
  16.        scheduler process when a    modem's    status changes;    e.g. when
  17.        a modem is busy with an outbound    call.
  18.  
  19.        One _f_a_x_g_e_t_t_y should be run for each facsimile modem  on    a
  20.        machine.      _f_a_x_g_e_t_t_y  is    typically  started by _i_n_i_t(${MAN
  21.        NUM1_8}).   _f_a_x_g_e_t_t_y  can  also    be  used  with    data-only
  22.        modems; this may    be desirable if    some of    the non-facsimile
  23.        features    are important, such as the support for    screening
  24.        calls according to Caller-ID information.
  25.  
  26.        _f_a_x_g_e_t_t_y    listens    to its facsimile modem for incoming calls
  27.        and to a    FIFO special file on  which  it     accepts  command
  28.        directives  from     administrative     commands  such    as _f_a_x_a_n_
  29.        _s_w_e_r(${MANNUM1_8}) and  _f_a_x_a_b_o_r_t(${MANNUM1_8}).     _f_a_x_g_e_t_t_y
  30.        also  catches  SIGTERM and SIGINT signals; cleaning up any
  31.        necessary resources before exiting.
  32.  
  33.        Many aspects of _f_a_x_g_e_t_t_y    operation are controlled  through
  34.        a  configuration     file.     In  particular,  for _f_a_x_g_e_t_t_y to
  35.        automatically invoke the     _g_e_t_t_y(${MANNUM1_8})  program  to
  36.        handle  incoming     data connections the GGeettttyyAArrggss    parameter
  37.        must be setup in    the configuration file.      The  configura
  38.        tion  file  is located in the spooler hierarchy in the eettcc
  39.        subdirectory and    is named ccoonnffiigg.._d_e_v_i_d,, where _d_e_v_i_d is  an
  40.        identifier  derived  from  the  name of the modem's device
  41.        file;  for  example  _t_t_y_m_2  for    _/_d_e_v_/_t_t_y_m_2,  _t_e_r_m___1_0  for
  42.        _/_d_e_v_/_t_e_r_m_/_1_0.   Consult    _h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MANNUM4_5})  for
  43.        detailed    information  on     the  contents    of  configuration
  44.        files.
  45.  
  46. OOPPTTIIOONNSS
  47.        --DD     This  option  forces  _f_a_x_g_e_t_t_y     to detach itself
  48.          from the  controlling    tty  from  which  it  was
  49.          invoked.   In normal operation    _f_a_x_g_e_t_t_y will nnoott
  50.          dissassociate itself from the controlling tty.
  51.  
  52.        --pp     Do not    change the process priority when  receiv
  53.          ing facsimile.     Normally _f_a_x_g_e_t_t_y will    raise its
  54.          priority to reduce i/o    latency.  This option  is
  55.          useful    for debugging.
  56.  
  57.        --qq _d_i_r     The specified directory is treated as the spool
  58.          ing area.  The    default    spooling area,    _$_{_S_P_O_O_L_},
  59.          is defined at the time    the software is    built.
  60.  
  61. FFIILLEESS
  62.        ${SPOOL}/FIFO._d_e_v_i_c_e         FIFO special file for submitting commands
  63.        ${SPOOL}/etc/config._d_e_v_i_c_e    device-specific configuration file
  64.  
  65.        Consult    _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5})  for a complete dis
  66.        cussion of the structure    and content of the spooling area.
  67.  
  68. SSEEEE AALLSSOO
  69.        _f_a_x_a_b_o_r_t(${MANNUM1_8}),    _f_a_x_a_n_s_w_e_r(${MANNUM1_8}),  _f_a_x_c_o_n_
  70.        _f_i_g(${MANNUM1_8}),   _f_a_x_s_t_a_t_e(${MANNUM1_8}),   _f_a_x_q(${MAN
  71.        NUM1_8}),    _g_e_t_t_y(${MANNUM1_8}),    _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MAN
  72.        NUM4_5}), _h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MANNUM4_5})
  73.  
  74.  
  75.  
  76.               July 31, 1995       FAXGETTY(${MANNUM1_8})
  77.